User endpoints
AddSamlUserExtension
AddSamlExtension(DataLayer.Entity.SAMLUserExtension,System.String,System.String)
Adds a SAML service to a user. This function is available only if Shibboleth is available for a virtual server. It does not apply to SAS Application Management.
Parameters
Param: extension: SAML user extension to add
Param: userName: User Name
Param: organization: Account
Returns
- True if added
SOAP 1.1 sample
The following is a sample SOAP 1.1 request and response. The placeholders shown need to be replaced with actual values.
Request:
Response:
SOAP 1.2 sample
The following is a sample SOAP 1.2 request and response. The placeholders shown need to be replaced with actual values.
Request:
Response:
AddUser
AddUser(DataLayer.Entity.User,System.String)
Adds a new user to the given organization. User name must be unique in the organization to which it is added.
Parameters
Param: user: User object to add
Param: organization: Account
Returns
True if the user was added
SOAP 1.1 sample
The following is a sample SOAP 1.1 request and response. The placeholders shown need to be replaced with actual values.
Request:
Response:
SOAP 1.2 sample
The following is a sample SOAP 1.2 request and response. The placeholders shown need to be replaced with actual values.
Request:
Response:
AddUserWithAlias
AddUserWithAlias(DataLayer.Entity.User,System.Collections.Generic.List{System.String},System.String)
Adds a new user with alias to the given organization. User name must be unique in the organization to which it is added.
Parameters
Param: user: User object to add
Param: Alias: Alias
Param: organization: Account
Returns
True if the user was added
SOAP 1.1 sample
The following is a sample SOAP 1.1 request and response. The placeholders shown need to be replaced with actual values.
Request:
Response:
SOAP 1.2 sample
The following is a sample SOAP 1.2 request and response. The placeholders shown need to be replaced with actual values.
Request:
Response:
GetUser
GetUser(System.String,System.String)
Gets a user.
Parameters
Param: userName: User name of the user to get.
Param: organization: Account
Returns
The user
SOAP 1.1 sample
The following is a sample SOAP 1.1 request and response. The placeholders shown need to be replaced with actual values.
Request:
Response:
SOAP 1.2 sample
The following is a sample SOAP 1.2 request and response. The placeholders shown need to be replaced with actual values.
Request:
Response:
HTTP GET sample
The following is a sample HTTP GET request and response. The placeholders shown need to be replaced with actual values.
Request:
Response:
HTTP POST sample
The following is a sample HTTP POST request and response. The placeholders shown need to be replaced with actual values.
Request:
Response:
GetUserAlias
GetUserAlias(System.String,System.String)
Gets a user's alias.
Parameters
Param: userName: User name of the user to get.
Param: organization: Account
Returns
The user's alias
SOAP 1.1 sample
The following is a sample SOAP 1.1 request and response. The placeholders shown need to be replaced with actual values.
Request:
Response:
SOAP 1.2 sample
The following is a sample SOAP 1.2 request and response. The placeholders shown need to be replaced with actual values.
Request:
Response:
HTTP GET sample
The following is a sample HTTP GET request and response. The placeholders shown need to be replaced with actual values.
Request:
Response:
HTTP POST sample
The following is a sample HTTP POST request and response. The placeholders shown need to be replaced with actual values.
Request:
Response:
GetUserInOperatorOrganization
GetUserInOperatorOrganization(System.String)
Gets a user in the same organization as the current operator.
Parameter
Param: userName: User name of the user to get.
Returns
The user
SOAP 1.1 sample
The following is a sample SOAP 1.1 request and response. The placeholders shown need to be replaced with actual values.
Request:
Response:
SOAP 1.2 sample
The following is a sample SOAP 1.2 request and response. The placeholders shown need to be replaced with actual values.
Request:
Response:
HTTP GET sample
The following is a sample HTTP GET request and response. The placeholders shown need to be replaced with actual values.
Request:
Response:
HTTP POST sample
The following is a sample HTTP POST request and response. The placeholders shown need to be replaced with actual values.
Request:
Response:
GetUsers
GetUsers(System.String,System.String,DataLayer.Entity.AuthMethod,System.String,System.Int32,System.Int32,System.String)
Gets a table of user information matching the provided filters.
Parameters
Param: userName: User Name (Wild card support, optional)
Param: lastName: Last Name (Wild card support, optional)
Param: authMethod: Authentication method: Any, Token, Password, External Credentials, Token Or Password, None
Param: container: Container (Wild card support, optional)
Param: firstRecord: First record to return
Param: pageSize: Number of records to return
Param: organization: Account
Returns
-
Lastname
-
Firstname
-
userid
-
custom1
-
authmethod
-
attributes
-
authstate
-
container
-
isDormant
SOAP 1.1 sample
The following is a sample SOAP 1.1 request and response. The placeholders shown need to be replaced with actual values.
Request:
Response:
SOAP 1.2 sample
The following is a sample SOAP 1.2 request and response. The placeholders shown need to be replaced with actual values.
Request:
Response:
HTTP GET sample
The following is a sample HTTP GET request and response. The placeholders shown need to be replaced with actual values.
Request:
Response:
HTTP POST sample
The following is a sample HTTP POST request and response. The placeholders shown need to be replaced with actual values.
Request:
Response:
GetUsersForContainer
GetUsersForContainer(System.String,System.String)
Get a list of users in the container
Parameters
Param: containerName: Container to return users in
Param: organization: Account
Returns
A table with the following columns:
-
Lastname
-
Firstname
-
Username
-
custom1
SOAP 1.1 sample
The following is a sample SOAP 1.1 request and response. The placeholders shown need to be replaced with actual values.
Request:
Response:
SOAP 1.2 sample
The following is a sample SOAP 1.2 request and response. The placeholders shown need to be replaced with actual values.
Request:
Response:
HTTP GET sample
The following is a sample HTTP GET request and response. The placeholders shown need to be replaced with actual values.
Request:
Response:
HTTP POST sample
The following is a sample HTTP POST request and response. The placeholders shown need to be replaced with actual values.
Request:
Response:
GetUsersForGroup
GetUsersForGroup(System.String,System.Boolean,DataLayer.Entity.GroupKind,System.String,System.String,System.String)
Gets a list of users based on search criteria. Can search for all members of a group or all users who are not a member of a given group.
Parameters
Param: groupName: Name of the group
Param: isAMember: If they are a member or not
Param: kind: Read Only, Writable or Both
Param: userName: User Name filter
Param: lastName: Last Name filter
Param: organization: Account
Returns
A table with the following columns:
-
Firstname
-
Lastname
-
Username
-
custom1
SOAP 1.1 sample
The following is a sample SOAP 1.1 request and response. The placeholders shown need to be replaced with actual values.
Request:
Response:
SOAP 1.2 sample
The following is a sample SOAP 1.2 request and response. The placeholders shown need to be replaced with actual values.
Request:
Response:
HTTP GET sample
The following is a sample HTTP GET request and response. The placeholders shown need to be replaced with actual values.
Request:
Response:
HTTP POST sample
The following is a sample HTTP POST request and response. The placeholders shown need to be replaced with actual values.
Request:
Response:
MoveUsers
MoveUsers(System.Collections.Generic.List{System.String},System.String,System.String)
Moves user and their tokens to a new container
Parameters
Param: userNames: User names of all users to move to the new container.
Param: newContainer: Name of an existing container to move the users to.
Param: organization: Account
Returns
True if the users are moved
SOAP 1.1 sample
The following is a sample SOAP 1.1 request and response. The placeholders shown need to be replaced with actual values.
Request:
Response:
SOAP 1.2 sample
The following is a sample SOAP 1.2 request and response. The placeholders shown need to be replaced with actual values.
Request:
Response:
ProvisionUsers
ProvisionUsers(System.Collections.Generic.List{System.String},DataLayer.Entity.ProvisioningEntry.TokenOption,System.String,System.String)
Provisions a list of users a token of a given class. SMS tokens will be instantly provisioned, all other types will have provisioning tasks added for the users.
Parameters
Param: userNames: Names of the users to provision tokens to
Param: tokenClass: The type of token to provision: Software, Oath, SMS, Password, KT, RB, ICE, GOLD, eToken
Param: description: Provisioning task description
Param: organization: Account
Returns
A list in the same order as the user names provided:
FailedToAddToBatch | Failed to add user to provisioning task |
EmailSent | Success |
SMSSent | Success for SMS tokens |
UserHasNoEmail | Can't provision to the user as they have no e-mail address |
UserHasNoMobileNumber | Can't provision an SMS token, as they have no mobile number |
FailedToSendEmail | Failed to send out the e-mail. Check e-mail settings for the account |
FailedToSendSMS | Failed to send out an SMS. Check SMS settings for the account |
FailedToSendSMS_NoCredits | The account does not have enough SMS credits to send the message |
CouldntGetToken | Couldn't find an available SMS or MP token to use for SMS provisioning |
CouldntAssignToken | User could not be assigned an SMS token |
UserHasActiveToken | Cannot provision password as the user has an active token |
SOAP 1.1 sample
The following is a sample SOAP 1.1 request and response. The placeholders shown need to be replaced with actual values.
Request:
Response:
SOAP 1.2 sample
The following is a sample SOAP 1.2 request and response. The placeholders shown need to be replaced with actual values.
Request:
Response:
RemoveUser
RemoveUser(System.String,System.String,ControlLibrary.TokenControl.revokeSelection,System.String)
Removes an existing user and revokes their tokens.
Parameters
Param: userName: User name of the user to remove
Param: organization: Account
Param: tokenOption: One of: ReturntoInventory_Initialized, ReturntoInventory_NotInitialized, Faulty, Lost
Param: comment: Message to attach to the tokens that are being revoked
Returns
-
Deleted
-
FailedToDeassignTokens
-
FailedToRemoveUser
-
UnknownError
SOAP 1.1 sample
The following is a sample SOAP 1.1 request and response. The placeholders shown need to be replaced with actual values.
Request:
Response:
SOAP 1.2 sample
The following is a sample SOAP 1.2 request and response. The placeholders shown need to be replaced with actual values.
Request:
Response:
HTTP GET sample
The following is a sample HTTP GET request and response. The placeholders shown need to be replaced with actual values.
Request:
Response:
HTTP POST sample
The following is a sample HTTP POST request and response. The placeholders shown need to be replaced with actual values.
Request:
Response:
UpdateUser
UpdateUser(System.String,DataLayer.Entity.User,System.String)
Updates an existing user in the system.
Parameters
Param: userName: User name of the user to update. If changing the user name, this is the old user name. New user name is in the user object
Param: user: Updated user
Param: organization: Account
Returns
True if updated
SOAP 1.1 sample
The following is a sample SOAP 1.1 request and response. The placeholders shown need to be replaced with actual values.
Request:
Response:
SOAP 1.2 sample
The following is a sample SOAP 1.2 request and response. The placeholders shown need to be replaced with actual values.
Request:
Response:
UpdateUserWithAlias
UpdateUserWithAlias(System.String,DataLayer.Entity.User,System.Collections.Generic.List{System.String},System.String)
Updates an existing user with alias in the system.
Parameters
Param: userName: User name of the user to update. If changing the user name, this is the old user name. New user name is in the user object
Param: user: Updated user
Param: Alias: Updated use' alias
Param: organization: Account
Returns
True if updated
SOAP 1.1 sample
The following is a sample SOAP 1.1 request and response. The placeholders shown need to be replaced with actual values.
Request:
Response:
SOAP 1.2 sample
The following is a sample SOAP 1.2 request and response. The placeholders shown need to be replaced with actual values.
Request:
Response: